Node / ReticulumProjects / MeshChatX.git / files / meshchatx / src / frontend / components / map / internal / clusterUtils.js

Displaying Raw • Download

T8b949e/**

* Pure helpers for the map's marker clustering logic.

*

* These functions intentionally avoid any direct dependency on Vue or

* OpenLayers internals so they can be unit-tested in isolation. They expect

* "feature" objects exposing a minimal subset of the OpenLayers Feature API:

* - feature.get(key) -> any

* - feature.getGeometry() -> { getCoordinates(): [x, y] } | null

*/

T8b949e/**

* Compute the diagonal length of an extent in map units. Used to detect

* degenerate (zero-area) clusters where every contained marker shares the

* exact same coordinate.

*

* @param {Array<number>|null|undefined} extent - [minX, minY, maxX, maxY]

* @returns {number} 0 for empty or non-finite extents, the diagonal length

* otherwise.

*/

Tff7b72export Tff7b72function Te6edf3extentDiagonalTb4b4b4(Te6edf3extentTb4b4b4) Tb4b4b4{

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3extent Tff7b72|| Te6edf3extentTb4b4b4.Te6edf3length Tff7b72< T79c0ff4Tb4b4b4) Tff7b72return T79c0ff0Tb4b4b4;

Tff7b72const Tb4b4b4[Te6edf3minXTb4b4b4, Te6edf3minYTb4b4b4, Te6edf3maxXTb4b4b4, Te6edf3maxYTb4b4b4] Tff7b72= Te6edf3extentTb4b4b4;

Tff7b72if Tb4b4b4(Tff7b72!Tb4b4b4[Te6edf3minXTb4b4b4, Te6edf3minYTb4b4b4, Te6edf3maxXTb4b4b4, Te6edf3maxYTb4b4b4]Tb4b4b4.Te6edf3everyTb4b4b4(Tb4b4b4(Te6edf3vTb4b4b4) Tb4b4b4=> Tffa657NumberTb4b4b4.Tffa657isFiniteTb4b4b4(Te6edf3vTb4b4b4)Tb4b4b4)Tb4b4b4) Tff7b72return T79c0ff0Tb4b4b4;

Tff7b72const Te6edf3dx Tff7b72= Te6edf3maxX Tff7b72- Te6edf3minXTb4b4b4;

Tff7b72const Te6edf3dy Tff7b72= Te6edf3maxY Tff7b72- Te6edf3minYTb4b4b4;

Tff7b72return Tffa657MathTb4b4b4.Te6edf3sqrtTb4b4b4(Te6edf3dx Tff7b72* Te6edf3dx Tff7b72+ Te6edf3dy Tff7b72* Te6edf3dyTb4b4b4)Tb4b4b4;

Tb4b4b4}

T8b949e/**

* Resolve the original (unclustered) coordinate of a feature, falling back to

* its geometry's current coordinates when no `originalCoord` was tracked.

*

* @param {object} feature

* @returns {Array<number>|null}

*/

Tff7b72export Tff7b72function Te6edf3getFeatureCoordTb4b4b4(Te6edf3featureTb4b4b4) Tb4b4b4{

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3feature Tff7b72|| Tff7b72typeof Te6edf3featureTb4b4b4.Te6edf3get Tff7b72!== Ta5d6ff"function"Tb4b4b4) Tff7b72return Tff7b72nullTb4b4b4;

Tff7b72const Te6edf3original Tff7b72= Te6edf3featureTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"originalCoord"Tb4b4b4)Tb4b4b4;

Tff7b72if Tb4b4b4(Te6edf3originalTb4b4b4) Tff7b72return Te6edf3originalTb4b4b4;

Tff7b72if Tb4b4b4(Tff7b72typeof Te6edf3featureTb4b4b4.Te6edf3getGeometry Tff7b72!== Ta5d6ff"function"Tb4b4b4) Tff7b72return Tff7b72nullTb4b4b4;

Tff7b72const Te6edf3geom Tff7b72= Te6edf3featureTb4b4b4.Te6edf3getGeometryTb4b4b4(Tb4b4b4)Tb4b4b4;

Tff7b72return Te6edf3geom Tff7b72&& Tff7b72typeof Te6edf3geomTb4b4b4.Te6edf3getCoordinates Tff7b72=== Ta5d6ff"function" Tff7b72? Te6edf3geomTb4b4b4.Te6edf3getCoordinatesTb4b4b4(Tb4b4b4) Tff7b72: Tff7b72nullTb4b4b4;

Tb4b4b4}

T8b949e/**

* Build a normalised summary of a cluster suitable for the cluster details

* overlay. Each entry exposes the source feature plus lightweight metadata

* (kind, label, identifier, coord).

*

* @param {object|null} feature - cluster feature with a "clusterItems" prop.

* @returns {Array<object>} normalised summary entries.

*/

Tff7b72export Tff7b72function Te6edf3buildClusterItemsTb4b4b4(Te6edf3featureTb4b4b4) Tb4b4b4{

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3featureTb4b4b4) Tff7b72return Tb4b4b4[Tb4b4b4]Tb4b4b4;

Tff7b72const Te6edf3rawItems Tff7b72= Te6edf3featureTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"clusterItems"Tb4b4b4) Tff7b72|| Tb4b4b4[Tb4b4b4]Tb4b4b4;

Tff7b72const Te6edf3summary Tff7b72= Tb4b4b4[Tb4b4b4]Tb4b4b4;

Tff7b72for Tb4b4b4(Tff7b72const Te6edf3item Tff7b72of Te6edf3rawItemsTb4b4b4) Tb4b4b4{

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3itemTb4b4b4) Tff7b72continueTb4b4b4;

Tff7b72const Te6edf3coord Tff7b72= Te6edf3getFeatureCoordTb4b4b4(Te6edf3itemTb4b4b4)Tb4b4b4;

Tff7b72const Te6edf3telemetry Tff7b72= Te6edf3itemTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"telemetry"Tb4b4b4)Tb4b4b4;

Tff7b72const Te6edf3peer Tff7b72= Te6edf3itemTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"peer"Tb4b4b4)Tb4b4b4;

Tff7b72const Te6edf3discovered Tff7b72= Te6edf3itemTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"discovered"Tb4b4b4)Tb4b4b4;

Tff7b72let Te6edf3kind Tff7b72= Ta5d6ff"unknown"Tb4b4b4;

Tff7b72let Te6edf3label Tff7b72= Ta5d6ff"Unknown"Tb4b4b4;

Tff7b72let Te6edf3identifier Tff7b72= Ta5d6ff""Tb4b4b4;

Tff7b72let Te6edf3iconKey Tff7b72= Tff7b72nullTb4b4b4;

Tff7b72if Tb4b4b4(Te6edf3telemetryTb4b4b4) Tb4b4b4{

Te6edf3kind Tff7b72= Ta5d6ff"telemetry"Tb4b4b4;

Te6edf3label Tff7b72= Te6edf3peerTff7b72?Tb4b4b4.Te6edf3display_name Tff7b72|| Tb4b4b4(Te6edf3telemetryTb4b4b4.Te6edf3destination_hash Tff7b72|| Ta5d6ff""Tb4b4b4)Tb4b4b4.Te6edf3substringTb4b4b4(T79c0ff0Tb4b4b4, T79c0ff8Tb4b4b4) Tff7b72|| Ta5d6ff"Peer"Tb4b4b4;

Te6edf3identifier Tff7b72= Te6edf3telemetryTb4b4b4.Te6edf3destination_hash Tff7b72|| Ta5d6ff""Tb4b4b4;

Tb4b4b4} Tff7b72else Tff7b72if Tb4b4b4(Te6edf3discoveredTb4b4b4) Tb4b4b4{

Te6edf3kind Tff7b72= Ta5d6ff"discovered"Tb4b4b4;

Te6edf3label Tff7b72= Te6edf3discoveredTb4b4b4.Te6edf3name Tff7b72|| Ta5d6ff"Discovered Interface"Tb4b4b4;

Te6edf3identifier Tff7b72= Te6edf3discoveredTb4b4b4.Tff7b72interface Tff7b72|| Te6edf3discoveredTb4b4b4.Te6edf3via Tff7b72|| Ta5d6ff""Tb4b4b4;

Te6edf3iconKey Tff7b72= Te6edf3discoveredTb4b4b4;

Tb4b4b4}

Te6edf3summaryTb4b4b4.Te6edf3pushTb4b4b4(Tb4b4b4{ Te6edf3featureTff7b72: Te6edf3itemTb4b4b4, Te6edf3kindTb4b4b4, Te6edf3labelTb4b4b4, Te6edf3identifierTb4b4b4, Te6edf3iconKeyTb4b4b4, Te6edf3coordTb4b4b4, Te6edf3telemetryTb4b4b4, Te6edf3peerTb4b4b4, Te6edf3discovered Tb4b4b4}Tb4b4b4)Tb4b4b4;

Tb4b4b4}

Tff7b72return Te6edf3summaryTb4b4b4;

Tb4b4b4}